home *** CD-ROM | disk | FTP | other *** search
/ CD Ware Multimedia 1995 May / cd Ware (Juegos) Epimundo.iso / DOS / TOOLS / DSTRIP.ZIP / DSTRIP.DOC < prev    next >
Encoding:
Text File  |  1993-01-04  |  4.5 KB  |  130 lines
  1.  
  2. DynaStrip (c) DYNASOFT 1993, CA 95617-0915, (916)758-1504, BBS: (916)753-8788
  3.  
  4.  
  5. DynaStrip was created by David M. Larson to meet the need for better control
  6. over the amount of debugging information in a large application. Borland
  7. currently uses 16 bit counters to keep track of certain things such as the 
  8. number of line number entries in an application.  This means that when your
  9. all your source code for your application approaches 65535 lines or more, you
  10. may not be able to link the application without eliminating debugging 
  11. information.  Borland has been kind enough to provide us with compile time
  12. options for this purpose.  However, we can waste a great deal of time figuring
  13. out which obj modules we need debugging on.  If it really is a large 
  14. application we may (at times) have no sense of what code is involved in a
  15. certain feature that is malfunctioning.  Borland has also supplied us with
  16. a simple utility called TDSTRIP to remove debugging information after 
  17. compiling, which lacks adequate options to solve the problem.
  18.  
  19. Therefore, I have created DSTRIP (DynaStrip) as an elegant solution which 
  20. allows selective stripping of debugging information.  The result is a
  21. linkable application with debugging information in every module.  This
  22. is accomplished by removing every other line number reference and / or 
  23. removing other debugging information.  This has the additional benefit
  24. of reducing the amount of information Borland's Turbo Debug has to manage.
  25. As soon as you determine which modules have the problem code, you can simply
  26. delete those object modules and recompile them with full debugging.
  27.  
  28.  
  29.  
  30. DynaStrip will search all subdirectories and process any .OBJ files
  31. which match the wildcard filespecs.  DynaStrip can selectively
  32. remove some of the debugging information allowing your application
  33. to link while maintaining a reasonable amount of debugging capabilities.
  34.  
  35.  
  36.  
  37. Usage: DSTRIP [options] [<path>\\]<wildcard filespec> ...
  38.  
  39. Options:
  40.     -b  = skip files already processed (with some line numbers removed).
  41.     -x  = exclude all files specified after this option.
  42.     -r  = suppress directory recursion.
  43.     -f  = call Borland's TDSTRIP on each file (default if no options)
  44.     -ln = strip some line number info
  45.           n is a value between 1 to 4 to set the strip rate
  46.     -o  = strip other debugging info
  47.     -c  = test obj record checksums
  48.     -d  = dump line number info
  49.     -t  = touch date and time (set to current)
  50. Notes: Any path on the first filespec is applied to all.
  51.        All options are separated by spaces
  52.  
  53.  
  54.  
  55.  
  56. Example:  DSTRIP -b -l -o V* -x video vm*
  57.  
  58.          This command would recurse directories and process any files
  59.          that match V*.OBJ except VIDEO.OBJ and VM*.OBJ.  The options
  60.          chosen are to strip some line numbers, strip other debugging 
  61.          information and not to process object files that already
  62.          have line numbers removed.
  63.  
  64.  
  65. -----------------------------
  66.  
  67.  
  68. Expanded Option Documentation:
  69.  
  70.  
  71.  
  72.     -b 
  73.  
  74. This option causes DynaStrip to avoid stripping more line numbers from
  75. an object file that has been previously stripped.
  76.  
  77.     -x
  78.  
  79. All files matching arguments following this argument are excluded from
  80. processing.
  81.  
  82.     -r
  83.  
  84. Use this option if do not wish to process subdirectories.
  85.  
  86.  
  87.     -f
  88.  
  89. Force DSTRIP to call Borland's TDSTRIP on each file.  This also happens if
  90. you don't specify any other processing options.
  91.  
  92.     -ln
  93.  
  94. Selectively remove line number information.  If n=1 (or is omitted), then 
  95. approximately every other line reference is removed
  96.  
  97.     -o
  98.  
  99. Remove debugging information other than line number information. This is
  100. similar to compiling with line number information only.
  101.  
  102.     -c
  103.  
  104. This option will report any object files that contain bad records
  105.  
  106.  
  107.     -d  = dump line number info
  108.  
  109. This options dumps summary information about line number records contained
  110. in your object files.
  111.  
  112.     -t  = touch date and time (set to current)
  113.  
  114. Normally DSTRIP does not alter the time-date stamp on your object files.
  115. If you wish it to do so, use this option.
  116.  
  117. -----------------------------
  118.  
  119.  
  120. We are making this version of DSTRIP available to you free of charge as
  121. a way of introducing our company.  We would like to learn more about you
  122. and your needs, so that we can develop tools to help you increase your
  123. productivity and the quality of your products.
  124.  
  125. We have some ideas for making improvements to DSTRIP if there is adequate
  126. interest in the product.
  127.  
  128. Please call the Dynasoft BBS at (916)753-8788 for support and registration.
  129.  
  130.